home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / libblas / rotmg.z / rotmg
Encoding:
Text File  |  1998-10-30  |  4.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ____RRRROOOOTTTTMMMMGGGG((((3333FFFF))))                                                          ____RRRROOOOTTTTMMMMGGGG((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      drotmg, srotmg - BLAS Level-1. Compute the elements of a modified Givens
  10.      plane rotation.
  11.  
  12. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ddddrrrroooottttmmmmgggg(((( dddd1111,,,, dddd2222,,,, xxxx1111,,,, yyyy1111,,,, ppppaaaarrrraaaammmm ))))
  14.      ddddoooouuuubbbblllleeee pppprrrreeeecccciiiissssiiiioooonnnn   dddd1111,,,, dddd2222,,,, xxxx1111,,,, yyyy1111
  15.      ddddoooouuuubbbblllleeee pppprrrreeeecccciiiissssiiiioooonnnn   ppppaaaarrrraaaammmm(((( 5555 ))))
  16.  
  17.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ssssrrrroooottttmmmmgggg(((( dddd1111,,,, dddd2222,,,, xxxx1111,,,, yyyy1111,,,, ppppaaaarrrraaaammmm ))))
  18.      rrrreeeeaaaallll               dddd1111,,,, dddd2222,,,, xxxx1111,,,, yyyy1111
  19.      rrrreeeeaaaallll               ppppaaaarrrraaaammmm(((( 5555 ))))
  20.  
  21.  
  22. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.      DDDDRRRROOOOTTTTMMMMGGGG and SSSSRRRROOOOTTTTMMMMGGGG compute the elements of a modified Givens rotation
  24.      matrix.
  25.  
  26.  
  27. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  28.      dddd1111      (input/output)
  29.              On input, this value is the first diagonal element of the scaling
  30.              matrix DDDD.  On first call to DROTMG or SROTMG, this value is
  31.              typically 1.0. Subsequent calls typically use the value from the
  32.              previous call.
  33.              On output, this value is the first diagonal element of the
  34.              updated scaling matrix DDDD''''.
  35.  
  36.      dddd2222      (input/output)
  37.              On input, this value is the second diagonal element of the
  38.              scaling matrix DDDD.  On first call to DROTMG or SROTMG, this value
  39.              is typically 1.0. Subsequent calls typically use the value from
  40.              the previous call.
  41.              On output, this value is the first diagonal element of the
  42.              updated scaling matrix DDDD''''.
  43.  
  44.      xxxx1111      (input/output)
  45.              On input, this value is the _x-coordinate of the vector used to
  46.              define the angle of rotation before scaling (multiplying by the
  47.              matrix D).
  48.              On output, this value is the _x-coordinate of the rotated vector
  49.              before scaling (multiplying by the matrix D').
  50.  
  51.      yyyy1111      (input/output)
  52.              On input, this value is the _y-coordinate of the vector used to
  53.              define the angle of rotation before scaling (multiplying by the
  54.              matrix D).
  55.              On output, this value is the _y coordinate of the rotated vecttor
  56.              before scaling (multiplying by the matrix D').
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ____RRRROOOOTTTTMMMMGGGG((((3333FFFF))))                                                          ____RRRROOOOTTTTMMMMGGGG((((3333FFFF))))
  71.  
  72.  
  73.  
  74.      ppppaaaarrrraaaammmm   (output)
  75.              This array contains rotation matrix information. DROTMG or SROTMG
  76.              set up the computed elements in param from inputs d1, d2, x1, and
  77.              y1.
  78.  
  79.  
  80. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  81.      DROTM or SROTM.
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.